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TOs AH CTS3 Users 

FROMi Ro Co Daley and Co Gamian 

SURJECTs l:D^ A Confcejtt Editor for Card ]n\ap,e [-tU'S 

fNTR0DUCTfCS^J3 

,^, ,^^,,l^^^ '^9'^^^^'^'^ ^or editing lh-^:.>oi'd BCD card Jmage flK-s 
wjtnin CISSc me command is based on TYPSET (CC-Ziiii^ MAC-M-ig-J 
u i^ "o Saltjrer) and many of the convent Foas of TYPSET are used 




The ED command Js offered as an alternate to the presenfc INPUt! 
ED 11 and FJlE commands o 



USAGES 

The ED command ?s fnftlated with the followInR' CTSS coniaiand 



o 



ED NAME! NMAE2 MAME3 

NAME2 Is the secondary name of the nie to be edited or creafed 
and must be provided f f ED Js to set the tabso MAMEl Is rhe 

primary nama of the fUe to be edltedo if fMMEl NAME2 ? ^3 not 
speclTJen, ED w?n assume that a new file Is to be created and 
win start In tha high-speed INPUT mode o if MAM El Is provided, 
Che command win look for the file NAME! NAME2o Ef the file' ll 
not foand^ th& high-speed I MPUT mode will be entered. if the 

rile Is founds the EDIT mode v;f1J be entered „ 

If NAME3 is specified and the file NAMEl MAME2 is found, the 
subsequent FILE vHn create a file MAMES NAN5E2o fJAMFl ^JAMF'-*' vjH 3* 
remain unaltered^ Any arguments to the FILE request, however. 
vnH take precedence o ^ -> a 
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HI fiH "SPEED .tiipjyrjl MonEs 



.....n,.^-^" '■'^^'. "^'^'' ^"^^'^^''^ ^'''^ ^'^^^'-^ *^^« "^^ command will iiype 
SMPUlg'' on the user's conso]eo Whfle the user Is opei-n'cing In 
r.h{3 mode# the ED command Mi\\\ accept Input lines fi'cni th? user's 



t 



console o Tabs wUI be Interpreted automat I caUy for each Input 
Hnso Fiackspace characters may also be used to move bade one 
character position In the Input 1 Inao No response Is typed for 
input lines and as a result^ the user may type .successive lines 
as fast as he vvIsheSo Whan the user types a line consisting only 
of a single carriage return^ the ED command wrii ^\i\ce ^he user'^i 
console In the EDIT moda. 

fMX MODES 

Whan the user enters this mode the response "EnjTj*' v/ril b«=» 
typed on the user^s console. At thS;5 time the user mav type 
requests to the ED corriiJand,, All changes made to a flip "become 
ertectlve immedfatJy and as a result, the ur^er is able to make 
recursive mod JfJcat Ions £o his f\\^.. Conceptually we may think 
of a pointer which Is positioned a**: a line In the edited file 
When the user enters the EDIT mode from the INPUT mode, this 
pointer will be positioned at the i^at Input line typed by the 
user„ When the user starts the £0 command In the EDIT mode- the 
pointer is positioned before the fSrat line In the old fn«1 if 

ac^'^m'^ llDll l^.t^?^"^^'®'^ ^^ ^■"' ^'^^''' request, the comment "EMD 
OF FILE REACHED BY" Is typed on the user's console followed by 
the request which caused tfie end of file to be reached^ At this 
Urns the pointer wlU be positioned after the last line In the 
rHGc When In the EDIT m.ode^ any ? jne which Is not a He-rtt Ima^e 
EDH request wU'l cause the comment "MOT A REQUEST" to be tyoed 
on the user^s console followed by the line which caused Hio 
arroro In many cases It \% possible for the user to stack EDIT 
requests If orse of the requests causes an error mesaagp fo be 
typed^ any stacked requests I'/HI be Ignoredo Thla Is' done In 
case one of the stacked requests depended on the succes<;fu^ 
completion of the request \n errorc 

Any number of Initial tabs or spaces (Including' a) mav occur 
sn a request '\ Ina^ Arguments and tha reque-it mav be separated bv 
a£ learit one space of any number of tabs or spacasc V.'ht" reverl 

the argument Is tsKt,, however^ tabs and spaces refcain" their 
norma 8 s Jgiii f Icance^ 

Warn In^g 

One Interrupt Is sei; which returns the user to FDIT mode. 
Use It 5parlnii1y^ as \t can result Fr. lost lines In fries U' us-^hI 
during any raqueyt which moves the pointer (FSf'O^ iOCATE etr„)o 
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REQUESTS KI.'JD II HE 

ASBREViATIOtii [•" 

RESPOHSL'j none 

L-RRORSi! £m OF FsLF 

The FIND request Is used to move the pointer forwai-'-! froin 
i t B p re sent posit! on t o the 1 J a e s peel v I e d b y I lHh\ LI M F J ;; a 
normal input ] Ina and may contain tabs and backspaces; , This 1 sno 
fii used as a mask for selecting the das I red line \n the edited 
FHeo Matching fs done on] y on r.he non "blank cha ractei^s 
fipeclfi'ed In LMiEo For example^ the t^mut^st,, 

F (tab)'-(tab)"ALPI-IA^l 

might be used to find the lUie^ 

LOOP TJX ALPHA^l^H 

REQUESTS LOCATE string 

ABB REV SAT J ON: L 

RESPONSES none 

HFiRORSs END OF FILE 

The LOCATE request Is used to mova the polt^tar forv/a-'d f"rom 
Its. present posltlorj to t:he f ? rst 'li'ne whJch contains the antirs 
character string 5pec!f!ad by '"strlng'-c, The full 'line of 3k 
characters ts scanned.^ so that "string'"'' may specify Une nuiiibei'So 
it Is racofmnanded that "strirtf;" incUids the leading zero.^ of the 
n'riii numbers to avoid any undesfred match v/Ith program co/ik tants ,-, 

REQUEST^ NEXT I 

ABGREV!AT50M2 H 

RESPOMSEii nona 

ERRORS? END OF Fi LE 

This request Is used to mo\,'G the pointer foi-ward from its 
present position in tha fJlSc ^"l" £p«-ifS'e« the niimber of S jneii 
to be skljjped ovsTo If S Is "0" or not specified,, it is assti.vied 
to be "I'" and tha pointer wMI be moved to the next ] 'uie in the 
filoo if the NEXT request is Klver; after the end of file has 
been reached, the_ pointer vji 1 i ba reset to the besinnsng of the 
fHe and moved "I" sines from thare,- 



REQUESTs DELETE S 

ABB REV S AT! ON L' D 

RESPONSES nona 

ERRORS? EMO OF File 
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The DELETE request wU I da ; :: c . "I" lines from the fie 
starting with the Una an which the pointer Is currently 
positioned. The ftoInt;ej: i.s .laft, aji .i:hs, .GfilSltXqQ vaj^gd by,. XM 
laal ll.nft dg„UJ;eci by, this, xe.cjm5.ko ^ '^ » .^^ "0" or left 
unspecified^ oniy the current line v/nl be deiextedo 



REQUESTS 
ABBREVIATIONS 
RESPONSES 
ERRORSs 



PRINT I L 

P 

printed 1 Ines 

FNO OP PI LE 



The PRINT request will priivc "I" lines from the rtle 

starting with the line at whlcl the pointer Is currently 
posltlonedo Upon completion of this request,, the Pointer will be 

left pointing to the last line prlntado If I Is or levt 

unspecified^ one line will be printedo mmaUv lines are 

printed without line numberso If the character "L" Is present In 

the PRINT request^ line numbers vdll be printed to the rlfcht or 
the ps'inted 1 fneSo 



REQUESTS RETYPE LINE 

ABBREVIATJONg R 

RESPONSES none 

ERRORS! none 

This request v;ll1 cause the line at which the pointer Is 
currently positioned to be replaced by LINEc LINE Is a normal 
Input line and may contain tabs and backspaceso Jh^ i5oia.!;.ex X§, 
aot moved b^^ thia £S3MS3X- 



REQUESTS TOP 

ABBREV8AT10NS T 

RESPONSES none 

ERRORSs none 

This request vHll cause the pointer 
positioned before the first line In the fSleo 



to be reset and 



REQUESTS 


BOTTOM 


ABBREVSATIONs 


B 


RESPONSES 


!NPUT 


ERRORS? 


none 



This request will cause the 
the last line In the fllec Upon 
user's console v/lll be placed In 
subsequent lines will be treated 
the filec 



pointer to be positioned after 
completion of this request the 
the high-speed INPUT modec All^ 
as Input and added to the end of 



'Anr 



REQUESTS !MS(TRT o 

ABBREVIATJONs ! 

Rr:SP0NSE3 INPUT2 

ERRORSg none 



This request v^ill cause the user^s console to be p'Jaced In 
l:ha high-speed ! TSPiJT modG<, AU sisbsficiuent lines uUl be treated 
as Input: and ina^rfted sltLS^S. '-iis 1 tne afc which the poFnter Is 
currently positionedc, Tf the SNiiERT request Is given ImmedJatly 
foHov/?ng a TOP request,^, the Jnse rted lines; vHH b« placed at tha 
beginning of the filer 

REQUESTS iMSERT } Jne 

ABB REV ! AT? ON s i 

Responivfi none 

Errors? none 

The INSERT request rnay be used to hfserf; a single line 
viSthoLit changing to the hlgh'-speii'd Input modao Line Is a normal 

Snput 1 fnec 

REQUEST^; CHANGE Qst r I ngl-Qst r v rrr^2a I 

ABBREVIAT10M.1 C 

RESPOMSl-s none 

ERRORS 'i END OF I-SIE 

This request \jIU eitamJne "s" Viruvz starting at the line at 
which tha poinsar Is ctirrantly pos! 5:lonedo Upon corupl efc Jon^ the 
pointer v/Jll be ^eft posTj-Jcaed at She 'Jast line exannned by this 
raqyesto If i 2 s "0'" or left unjipec If led,^ It Is assumed to ba 
""1" and only the current 1 Jrfe vii'l'i h« ei',am?ned,. The character 

"Q" l3 taken to ba the del Inaator or "Quote character" and may be 
any character in the 5™b?t BCD seto "stringl" and "strlng2" are 
arbHtrary BCD character strings and r,;ay ba of different lengthSo 
If the chsractar '''G^' (GLOBAL) Is psesant,, ii:£SJJl occurr&ncQ of 
strlnsl will be replaced by strlng2o If "G" Is not present^ only 
the first occurence of string! wHl bn rep^Jaced by str?ng2 In 
each QjiamSned Hneo flXAMFLESs 



1 ?nes 




ALPHAS ALPHA'H'.IPHA 


requests 


C 


"^ A L PH A -MJ ET A ^ 


navj 1 In as 




BETA^i> ALPHA-:- ALPHA 


requests 


C 


'alphaMjelta^' 1 fi 


nsv/ 1 lne-2 




BETA- DELTA'i-nELTA 


requests 


c 


^OELTA'^"^ 


nevi I fnes 




BETA^'^ DtaTA 
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REQUESTS 


BLA^5K 1 


ABBREVJATIOH 


BL 


RHSPOfJSEs 


none 


ERRORS s 


none 



]Ui 



The BLANK request will pufc blanks \n i:he current 
v^liis rever nori'"blank chGrnsters appear In "line",, for ejcampla 
oonooo^ viiW clear the labal field of a line in a FAP flli 



1 Jne 
'RL 



!e. 



REQUESTS 


OVRLAY 


ABBREVJATtOMs 





RESPOfJSEs 


none 


ERRORS'.' 


none 



\ line 



The OVRLAY raquest v;s1l place the non-blank characters of 
"Hna" Infco the corresponding posJelon of the current 1 Ine- 
Hotlce that only non^blank characters of "line" replace what was 



?n the curr«2nt line. 



than 

win produce 



EOF (tab) 
EOF 



For example !n a FAP fil; . 
TXi '^^l 

bbH Cs:ab)Ct:ab) comment 

TXH »*1 comirient 



If tha current 



REQUESTS 
ABBREViATSOM: 
RESPONSE g 
ERRORSs 



VERIFY 
VE 

none 
none 



The VERJFY request sets the verify mode,. hi the verify mode,. 
l:he requests F3MD^ NEXT^ LOCATE,, OVRLAY^ BLANK and CHANGE wUl 
cause the printing of the curient-^po inter nna„ In addJt-Jon,. 

CHANGE \-iU] cause the printing; of all changed UneSo Requests 

may not be stacked v^hlls in the verify inodeo 



REQUESTS 


BRIE 


ABBREVIATE ON K 


BR 


RESPONSES 


none 


ERR0RS3 


n orj e 



The BR5EF 
brief mode J 



request set 
the FJMD,^ 



the brief or norma? mode^- VJItiiln the 



[•■iEXT, LOCATE. OVRLAY 



BLANK, 



CHANO}? 



requests wHl /, Jve no response 
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REQUESTS CLIP "ON' or ■OF;-' 

ABBREVlATIOMs CL 

RESPONSES none 

ERRORSs TRUNCATEDg 



The request CLIP ON sefcs a mode such that any Input line 
which exceeds column 72 wtll cause the message "TRUNCATEDs" 
followed by the faulty line ImagGo Any v/altfng Input lines vjU] 
have been deletedo Requests on which this may occur are FIMD/, 
INSERT^ RETYPE^ OVRLAY^ BLAMK and high-speed I MPUTn The request 
CLIP OFF resets the mode to Its normal settlngo 



REQUESTS 


SER! 


ABBREVIATIONS 


S 


RESPONSES 


none 


ERRORSs 


none 



This request Is used to change the Increment betvjeen 1 Ina 
numbers of successive lines to the Increment specified by the 
decimal Integer "N"c Initially^ this Increment Is set to 10 by 
the ED comiiiando If N Is "0" or not specified^. It Is assumed to 
be "10"c Lines Inserted after a line vjlth the line number ''L" 
v/Ul be sequenced L'4N^ L"S'2K% L*3N^. etCc If the lines fo!1ov;3ng 
the Inserted lines have line numbers which are leas than or equal 
to the line number of the last Inserted 1 Ine^ as many Hne-s as 
necessary v/Ili be resequenced to Insure that all line numbers are 
unlqLse and In ascending ordero For e:tample^ assume that "N" is 2 
and the user wSshes to Insert 9 lines after line 25 In a file 
that v/as previously sequenced by flveSo The Inserted lines would 
be numbered^ 27^ 29^ 31 ooo k'S o The lines previously numbered^ 
30^ 35<j k(i(, US and 50 v/ould be rsinumbered to^ hSg hi ^ '^9^ 51 and 
53 respect I vel yo The ramaining lines In the file would be 
unchansetlo 



REQUESTS 


COLON a 


ABBREVIATIONS 


CO 


RESPONSES 


none 


ERRORSs 


Illegal argument 



A colon Cor backspace on 105C) is a logical backspace 
anyivhere ego^ ^ABC sss Db(CoRo) is Interpreted as H)bC''c The 

colon moves the character pointer back one but does no£ erase the 
chat'-'aeters over which It has movedo One should be careful in 
using this convention that the total number of characters does 
not exceed 8'}^, as any extras v/Ill be added to the next ^\n& 
during I NFUTi, or result; In a request during EDlTc 

The COLON rsqueat allows the colon character to be Inserted 
as tev.t„ (They may also be '' CHANGE'' d In as desired^) If '^a" Is T 
or TESTi,. all '^ s " will be treated as text except for the ^ i^ as 
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the fli'st character after a tab„ !r '^a" Is B or RACKUP the 
normal mode win be reinstated and <:j H " s * wUl be backspaces ., 

REQUESTS TABSET Tl T2 .0. TM 

ABBREVIATIOMy TA 

RESPOMSt's none 

ERRORSs iLLEfiAL TAB SETTUir^ 

TJ specify the coluninij at which tabs are to be seto Tabs 

must be set In ascending order and may not exceed column 8ii. 

REQUESTS r-!LE - NAMEl - MAM':''. - 

ABB REV 5 AT 10 Ms FL 

RESPONSES Ready message from CTSS 

ERRORS S HO FILE NAME GH/EN 

Thfs reqyesfc Is used Eo termsnate f.he editing process and 
i^/rSte the new edited fUe on the d!sko NAME! specIMes the 

primary name of fche new file to be created o i^ NAME?. Is not 

specified^ the secondary name of ths original fSKe or fche ED 
command MAME2 argument vHII be uaedo 5f ^MME1 MAME2 Is not 

specs fled^ the old fHe wHs be replaced by the edited t-fle. Ir 
no name v/as rjven by the Inlitlal ED command or by the FILE 
request^ an error massage wUI be p?'tated and the FILE request 
wHI be Ignoredo 



